home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_geomview.idb / usr / freeware / catman / p_man / cat3 / plcombine.Z / plcombine
Encoding:
Text File  |  1999-01-26  |  2.5 KB  |  67 lines

  1.  
  2.  
  3.  
  4.      ppppllllccccoooommmmbbbbiiiinnnneeee((((3333))))     GGGGeeeeoooommmmeeeettttrrrryyyy CCCCeeeennnntttteeeerrrr ((((JJJJuuuunnnneeee 11115555,,,,    1111999999992222))))      ppppllllccccoooommmmbbbbiiiinnnneeee((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       PLCombine - polylist two polylists (OFF file format) into
  10.       one
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       Geom *PLCombine(Geom *, Geom *);
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.       PLCombine() combines two polylists into a single polylist
  17.       and returns the new polylist.     If either of the old
  18.       polylists was    NULL, a    copy of    the other polylist (or NULL if
  19.       both polylists were NULL) is returned.  PLCombine() will
  20.       generate an error if either of the parameters    was not    of the
  21.       polylist type.
  22.  
  23.       If the two polylists represent color in an inconsistant way,
  24.       PLCombine will attempt to preserve the color data.  If
  25.       either polylist has per-polygon colors, the result will have
  26.       per-polygon colors.  If the other object originally had
  27.       per-vertex colors, the color of the first point of each
  28.       polygon will be used as the color of the polygon.  If    the
  29.       other    polylist originally had    no colors, the rgba value
  30.       0.15,    0.15, 0.15, 1.0    will be    used as    the color of each of
  31.       that polyline's polygons.
  32.  
  33.       If neither of    the polylists had per-polygon colors but one
  34.       had per-vertex colors, the value 0.15, 0.15, 0.15, 1.0 will
  35.       be used as the color value for each of the vertices of the
  36.       colorless polylist.
  37.  
  38.       If neither polylist had color    data, the result will not have
  39.       color    date.
  40.  
  41.       The result of    PLCombine() will not include  normal data if
  42.       the two polylists represent normals in an inconsistent way,
  43.       for example, if one has per-vertex data and one has per-face
  44.       data or one has per-vertex data and one has no data.
  45.  
  46.      LLLLIIIINNNNKKKKIIIINNNNGGGG
  47.       PLCombine() is part of the geomutil library; see geomutil(3)
  48.       for information on how to link your program with this
  49.       library.
  50.  
  51.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  52.       offcombine(1), geomview(1), geomutil(3)
  53.  
  54.      AAAAUUUUTTTTHHHHOOOORRRR
  55.       Celeste Fowler          email: fowler@geom.umn.edu
  56.       The Geometry Center          phone: (612) 626-8304
  57.       1300 South Second Street
  58.       Minneapolis, MN  55454
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 12/22/98)
  64.  
  65.  
  66.  
  67.